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Read This First 


READ THIS FIRST 
SunOS Release 4.1.1 

This READ THIS FIRST (RTF) provides information not available in earlier SunOS 4.1.1 documentation. There are 
three main sections. The first describes problems with SunOS 4.1.1 release software that were identified after the 
SunOS 4.1.1 Release Manual went into production. The second section describes problems with OpenWindows and 
goes over recommended procedures for installing and using OpenWindows. The third section is an OpenWindows 
Tutorial. 

After reading this RTF, you should turn to the SunOS 4.1.1 Release Manual t^fore attempting to run or install 
SunOS 4.1.1. 


Getting Help 

If you have problems installing or using SunOS 4.1.1, call Sun Microsystems with the information outlined below. In 
the United States you can call l-8(X)-USA-4-SUN; outside the U.S., contact your local Sun Answer Center or your 
Sun sales representative for assistance. 

You Will Need to Provide the Following Information: 

□ Your name and electronic mail address (if any) 

□ Your company name, address, and phone number 

□ The model and serial number of your workstation 

□ Additional information provided by the showr e v(8) command (described in Chapter 3, Section 3.11 of the 
SunOS 4.1.1 Release Manual): 

- your system’s hostname 

- hostid 

- kernel and application architecture 

- kernel revision 

- SunOS release number 

□ Any information that may help to diagnose the problem. 

Call your sales representative if you have questions about Sun support services or your shipment. 


^sun 
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SunOS Release 4.1«1 

This section goes over problems with SunOS 4.1.1. When available, bug ID*s are given in parentheses after headings. 
The ID’s can be used to reference problems if you need to contact a Sun Answer Center or sales representative. 


“Full Install’’ Option Under Quick Install Does Not Create /home Partition on 207MB Disks (1044999) 

If you choose the “Full Install” option under Quick Install to load release software on a 207MB disk, /home is 

created as a symbolic link to /usr / export / home in order to make optimal use of disk space. 


Some Network Services Invoked by inetd May Fall to Run (1045211^ 1042491) 

The program inetd(8c) provides an internetwork daemon that invokes network services listed in the file 

/etc/inetd. conf. On rare occasions, the service invoked fails to run. The service most likely to fail is tftpd, 

which is necessary for booting diskless clients. Two other services that may be affected are in. cmsd (OpenWin- 
dows Calendar Manager) and in. comsat (Mail Tool). 

If a service invoked by inetd fails to run, terminate inetd and restart it. To terminate inetd: 

□ Get the process ID for inetd: 





. . ■>, 


ps “uax 1 

1 grep inetd 





J 


The process ID is the first number in the process table that results. In the example below, the process ID for 

inetd is 153. 


— 

%ps -uas: j 

grep 

inetd 










gavg 

6041 

2,7 

5,5 

40 

192 

p2 

S 

10:54 

0:00 

grep inetd 


root 

L. 

153 

,0.0 

0.0 

56 

0 

■p 

IW 

Oct 12 

0:30 

inetd 

J 


Note: Sample display; contents may vary, depending on user input and the system used. 


□ Become superuser, terminate the process (15 3 in the example), and restart inet d: 


r 


%su 


Password; [root password} 


#kill 153 


#/usr/etc/inetd 


V_ 

- • • • • J 


textdomain(3) Requires Two Arguments (1045495) 

The SunOS Reference Manual documents the text domain (3) library function as only requiring a single argument. 
However, the code for textdomainO expects a second argument. Without the argument, a program calling 
textdomainO dies with a segmentation violation. The second argument has no operational effect. It was called 
for in the original design of the function, but when the design changed and it was no longer necessary, the code that 
tested for its presence was never dropped. 
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The woricaroimd for the problem is to use a dummy second argument in programs that call text domain (): 
text domain ("domain_name", " " ) ; 


GS Systems Require 4.1.1-GFX Rev.l 

Systems configured with the GS graphics accelerator/frame buffer board require the 4.1.1-GFX Rev.l software sup¬ 
plement to SunOS 4.1.1. The 4.1.1-GFX Rev.l tape and documentation are included with every GS system or upgrade 
kit. The tape should be installed as the final step in setting up your system. Consult the 4.1.1 -GFX Rev. 1 documenta¬ 
tion for further information. 


Using the Sun View Version of the OPEN LOOK Deskset on 24-Bit Systems 

The SunView version of the OPEN LOOK Deskset displays strange colors and other undesired effects when used on a 
24—bit frame buffer. This includes the TC, GXP and GS systems. We recommend you do not use the SunView ver¬ 
sion of OPEN LOOK Deskset with any of these systems. 


Misprint in Instructions for Loading and Booting the Mlniroot from Remote CD-ROM 

There is a misprint in the second box on page 195 of Installing the SunOS. The last line in the box should not show a 
“/” before mlniroot_k~arch. The line should appear as follows: 

# cp m3.ii.x3::oot,_k-arch /export /exec/kvm/^-arcA. sunos /miniroot 


Sun Database Excelerator (DBE) 1.0 Not Supported under SunOS 4.1.1 
Do not use DBE 1.0 with SunOS 4.1.1; it is not supported. 


Sun Cross Compilers 3.0 Not Supported under SunOS 4.1.1 

Do not use Sun Cross Compilers 3.0 with SunOS 4.1.1; they are not supported. 


Disk Label of Second 104MB Disk on Desktop SPARCsystem May Be Incorrect (1045344) 

If you get the following message the first time you turn your system on, your second 104MB disk has an incorrect 
disk label. 


sdl at espO target 1 lun 0 

sdl: corrupt label - wrong magic number 

sdl: Vendor ^Quantum'’, product 'PlOSSS'’, 205075 512 byte blocks 


To correct the label, carry out the following steps: 


^sun 
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%3U 

Password; ienter root password] 

#format 

Searching for disks...done 
AVAILABLE DISK SELECTIONS: 

0, sdO at espO slave 24 

sdO: <Quantuin PrcDrive 105S cyl 974 ait 2 hd 6 sec 35> 
1. sdl at espO slave 8 

sdl: <Quantum ProDrive 105S cyl 974 alt 2 hd 6 sec 35> 
Specify disk, (enter its number) : 


Specify disk (enter its number): 1 
selecting sdl: <Quantum ProDrive 105S> 

[disk formatted, defect list found] 

FORMAT MENU; 

disk - select a disk 

type ~ select (define) a disk type 

partition - select (define) a partition table 

current - describe the current disk 

format - format and analyze the disk 

repair ~ repair a defective sector 

show - translate a, disk address 

label - write label to the disk 

analyze surface analysis 

defect - defect list management 

backup - search for backup labels 




Asun 
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3 . Enter commands as shown in the following sequence of screen prompts and user responses; 



format> defect 
DEFECT MENU: 


defect> coiMiit 

working list was not modified 
defect> quit 
FORMAT MENU 


Total of 0 defective blocks repaired 
format> partition 
PARTITION MENU: 


partition> select 

0. Quantum ProDrive 105S 
1. original sdl 

Specify table (enter its number) [1] 
partition^ lalsel 

Ready to label disk, continue? yes 

partition>quit 

FORMAT MENU: 


The root prompt (#) is now displayed, and you are ready to proceed to other matters. 


C++ Header Files Must be Modified for Use under SunOS 4.1.1 

Eight C++ header files under the in cl directory of the C++ 2.0 patch need to be modified in order to be fully com¬ 
patible with SunOS 4.1.1. Three of the files require important changes that are described in detail, below. The 
remaining files need to have new macro definitions added, and also, in one case, a new struct definition. 


Asun 
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Changes to be Made in incl/n»n/openprom. h 

Change lines 167 to 195 for struct sunromvec in the file incl/mon/openprom. h of your C++ patch 
directory to apf^ar as shown below (changes are in boldface): 

f .. 


void 

{.*Dp_chain) {Gaddr____t virt,, u__int size, caddr__t ®otry, 

'argaddr, arglen) ; 

void 

#else 

(*op__r®l«ae®) {ca^x_t virt, i2__infc aiz®); 

phandle_t 

(*op_phandle) (/* ihandle_t ihandle ^/); 

/*'. Con vert ihandle to. phandle */ 

caddr_t 

(*op_allQc) (/* caddr_t virthint, u_-int size */); 

/* Allocate physical memory */ 

void 

(*op_free) {/* caddr_t virt, u__int size.^/); 

/*■ Deallocate physical memory */ 

caddx_t 

(*op map){/* caddr_t virthint, ti_int space, u_int phys, u_int size */) ; 


Create device mapping */ 

void 

(tQp__iinmap): (/*, ■caddr.:.,t,..,virt> .u_int,..,size 

• /* Destroy device.mapping */ 

ihandle t. 

(+op open) (/* char *name ’*/) ; • 

u_int 

{*op_close.} (/* ihandle__t. fileid */); 

int 

i*op_read) (/* ihandle_t fileid, caddr__t bnf, ti__int len */) ; 

int 

{*op_v/rite) (/* ihandle t- fileid, caddr_t buf, u_int len */) ; 

int 

(’'*Qp seek) {/*■ ihandle t fileid, u int offsh,^ u int-offsl */) ; 

void 

(*op_chain} (/* caddr_t virt, u_int size, caddr_t ©ntry, 
caddr t argaddr, u int arglan */); 

void 

(*Gp roleas®) {/* caddr__t virt, u__int siza */}; 

tendif 


int 

reservedtlS] ; 


7 


Change to be Made In incl/pixrect/cgSvar. h 

Add int real__windowfd; as the last field for struct cg8_data, as shown below: 
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struct cgS^data 

{ 


Struct 

mprp_data 

mprp; 

/* 

memory pixrect simulator */ 

int 


flags; 

/* 

misc. flags */ 

int 


planes;;:: 

/* 

current group and mask */ 

int 


fd; 

/*. 

file descriptor */ 

short 


active; 

/* 

active no. */ 

struct 

cg4fb 

[CG8_NFBS]; 

/* 

frame buffer info */ 

int 


windowfd; 

/* 

if 8-bit indexed pw */ 

struct 

colormapseg 

cms; 

/* 

if 8 -bit indexed pr */ 

int 


real__windowfd; 

/* 

if 8-bit indexed pw */ 


(U_ J 


Change to be Made in incl/sundev/scsi. h 

Add struct scsi unit *c drainun; as the fifth field of struct scsi ctlr, as shown below: 


r — 

struct scsi_ctlr { 





int 

c_f lags; 


/* 

misc state flags */ 


int 

c_reg; 


/* 

controller registers in I/O space */ 


int 

c_intpri; 


/* 

controller interrupt priority */ 


struct 

scsi_unit 

* c_un; 

/* 

scsi unit using the bus */ 


struct 

scsi_unit 

*c__drainun; 

/* 

scsi unit being drained */ 

V, 

struct- 

scsi_ctlr_ 

_subr *c_ss; 

/* 

scsi device subroutines */ 

_ / 


Changes to be Made in Additional C++ 2.0 Header Files 
New macro definitions should be added to the following header files: 

incl/pixrect/cgl2_var.h 
incl/pixrect/gplcmds.h 
incl/pixrect/pr__dblbuf. h 
incl/pixrect/pr_planegroups.h 
incl/sun/autoconf.h 

In addition, struct dev_path_ops should be added to incl/sun/autoconf . h. To make the 
changes, carry out the following steps: 

□ dif f each header file in the above list with the corresponding file in /usr/include. For example: 


^ __ ^ _ __ ^ ^ ____— 

%diff [C++ _pa(chjdirectory ]/incl/pixrect/cgl2_var.h \ 

/usr/include/pixrect/cgl2__var.h > header.diff 
- - - - ■ _:_______^ 


□ Examine the differences and copy new macro definitions (plus the new struct) to the appropriate header 
files. 



sun 
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OPENWINDOWS VERSION 2 

This section recommends procedures for installing and using OpenWindows and goes over known problems with 
OpenWindows Version 2. 


Reporting Bugs 

Please inform us of any bugs you find in the operation of OpenWindows. You can do this by filling out a bug report 
and sending it to us, as described below. If you need more immediate assistance, you can contact us directly, as 
described under “Getting Help” at the beginning of this RTF. 

To help us process bug reports as quickly and smoothly as possible, please: 

1, Use the template bug form in /usr/openwin/share/bugform. If you are uncertain about the entry 
for bug category, you can leave that part of the template blank, or put in a tentative category, which we will 
review in any event. 

2. Send bugs via electronic mail to sun. com! sunbugs, not the windowsbug alias given in the template. 

(Customers with software support contracts can also send email to sun 1 hotline or call Sun Microsys¬ 
tems directly.) 


Desktop SPARCsystems with Two 104MB Disks: Using Your Second Disk for OpenWindows 

If you use the first 104MB disk of a Desktop SPARCsystem as the system disk for SunOS 4.1.1 release software, 
there will not be enough room for O^nWindows. This section describes how to use the g partition of your second 
disk (sdlg) for OpenWindows. 

The SunOS 4.1.1 Release Manual describes how to use sdlg as /home. Following the instructions given here or 
in the Release Manual, you cannot use sdlg for both /home and OpenWindows, and must chose between one use 
or the other. If you put OpenWindows in sdlg, you will have about 21MB of space in /usr on your first disk for 
use by /home. Experienced users who want to have more options in using their second disk should refer to the Sys¬ 
tem and Network Administration manual, which provides detailed information on disk partitioning, mounting parti¬ 
tions, and using symbolic links. 

The procedures you need to follow in using sdlg for OpenWindows depend on whether or not you use SunInstall to 
install SunOS 4.1.1 release software. If you use SunInstall, you can set up a /usr / openwin filesystem in sdlg 
from the start (See Installing the SunOS for instmctions on setting up file systems on a second disk). After using 
SunInstall you can load OpenWindows in sdlg by following the instructions given in the section “Installing the 

OpenWindows Software in sdlg”, below.* 

If you have the preinstalled version of SunOS 4.1.1 on your first disk or you use re-preinstall or Quick Install, you 
will need to create a /usr / openwin filesystem in sdlg and carry out additional steps before your can load 
OpenWindows into sdlg. 

Systems with SunOS 4 through Preinstallation, Quick Install, or Re-preinstall 

To use the g partition of your second disk for OpenWindows: 

1. Become superuser (you will need to be superuser for the remaining steps) and create a new filesystem in 
sdlg. This will be your OpenWindows filesystem. 

* Do ncH try to load OpenWindows into sdlg with SunInstall. SunInstall will balk, with the message that there is insufficient space. 
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%su 

Password: [enter root password] 

#newfs /dev/rsdlg 

/dev/rsdlg: 160230 sectors iii 763 cylinders of 6 tracks, 35 sectors 
82.0MB in 48 cyl groups (16 c/g, l,72MB/g, 768 i/g) 
super-block backups (for fsck -b #) at: 

32, 3440, 6848, 10256, 13664, 17072, 20480, 23888, 26912, 

30320, 33728, 37136, 40544, 43952, 47360, 50768, 53792, 57200, 

€0608, 64016, 67424, 70832, 74240, 77648, 80672, 84080, 87488, 

90896, 94304, 97712, 101120, 104528, 107552, 110960, 114368, 117776, 
121184, 124592, 128000, 131408, 134432, 137840, 141248, 144656, 148064 
151472, 154880, 158288, 


Note: Sample display; contents may vary, depending on user input and the system used, 


2. Use f sck to check the new filesystem 


#fsck /dev/rsdlg 

** /dev/rsdlg 
** Last Mounted on 

** Phase 1 - Check Blocks and Si 2 es 
** phase 2 - Check Pathnames 
Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl groups 
2 files, 9 used, 74713 free (17 frags 


Transfer the contents of /usr/openwin on your first disk to your new filesystem in sdlg. These 
contents, subdirectories and symbolic links for use by OpenWindows, were preinstalled or set up when 
you used Quick Install or re- preinstall. 


tmount /dev/sdlg /mnt 

#cd /usr/openwin 

#tar cfh - . 1 ( cd /mnt 


Make sure the transfer was carried out correctly; compare the contents of /usr/openwin and 
sdlg: 


#ls -F /usr/openwin 

bin/ etc(3 lib/ man(3 

demo/ include@ local/ share/ 

#ls “F /mnt 

bin/ etc@ lib/ man@ 

demo/. include® local/ share/ 


5. If the contents matched, remove the contents of / usr/openwin from /usr on your first disk: 


msun 

miCTosysteTO 
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#3cm -rf /usr/op€®win/* 


6. Edit your /etc/ f stab file so that your OpenWindows filesystem on sdlg is automatically 

mounted as /usr/openwin whenever you boot your system. Open /etc/f stab and add the line: 


/dev/sdlg /usr/openwin 4.2 rw 1 2 | 

_i 


7. Mount sdlgon /usr/openwin: 



tmoiint /usr/openwin 






You are now ready to load the O^nWindows software. The remaining steps are the same as those for systems 
that defined the /usr/openwin partition using Suninstall. 

Installing the OpenWindows Software in sdlg 

To install OpenWindows in the filesystem you created in sdlg, change directories to /usr and use the new 

extract__f iles(8) command to load the OpenWindows software categories from your SunOS 4.1.1 release 
media.* You must be superuser to use extract_f iles. 


- 

#cd /usr 

#/usr/etc/in.stall/extract._files devicemmber OpenWind©w8__U3ers 

#/usr/etc/install/eastract_files devicenumber OpenWindows_pejBO 
#/usr/et.c/install/extract___filas devicenumber OpenWindows__Fonts 
#/usr/etc/install/extract_files devicenumber OpenWindows_PrograiniRers 

... . . ^ __ 

- Replace devicenumber with the tape device number, if you are installing from tape, or with sr 0 if you are 

installing from CD-ROM. 

Note that you do not need to load OpenWindows_Programiner s unless you plan to develop window-based 
applications that will run in an OpenWindows environment. 


OpenWindows Calendar Manager May Use Incorrect Time Zone When First Run (1045264) 

If you are planning to use OpenWindows and you did not install OpenWindows using Sunlnstall’s “Custom installa¬ 
tion”, the first time you boot your system you should log in as root and run t z setup. You can then exit, and log in 
under your user name: 


* In addition to the man page for ext ract__f iles, see Chapters, Section 3.6, of the SunOS 4.1.1 Release Manual for information on using 
extract files. 


Asun 
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A . ... 


login: root 


Password: tenter root password] 


#/usr/etc/trsetup 


#exit 


login: [ enter username ] 

V______ 



1 2 setup is necessary for giving the Open Windows Calendar Manager the correct time zone. Without it, the Calen¬ 
dar Manager assumes Greenwich Mean Time. Unless you carry out a Suninstall “Custom installation” to load 
OpenWindows, t z setup will not run the first time your system boots, and you need to run it manually before using 
the Calendar manager, t z setup runs automatically whenever your system reboots. 


. xinitrc File in /home Must Be Removed or Edited 

If you already have a . xinitrc file in your home directory, make sure you either remove it or edit it according to 
the instructions in Chapter 2 of the Of^nWindows Installation and Start-Up Guide before you start Of^nWindows 
for the first time. 


Error Message for Incorrectly Set Keyboard DIP Switches 

In the unlikely event that your keyboard DIP switches are set incorrectly, you will see the following message when 
you start up OpenWindows: 


ClassKeyboard couldn't initialize the keyboard. 

Process: 0xlebc9c (Unnamed process) Error: undefined 
Stack: (NeWS/interest.ps) marker /BasicKeyDicts marker 

Executing: asciiOOO 

At: {*ascii000 asciiOSO asciiOOL asciiOSO asciiCOO asciiCOO asciiCOO 
asciiCOO} 

In: Reading file ('NeWS/interest.ps',R) 

Sic transit gloria PostScript 
giving up. 

xinit: Connection refused (errno 61): unable to connect to server 

^ 


If you are using a Type-4 keyboard and SunOS 4.1.1, all DIP switches on a U.S. keyboard must be set to "0” or "off. 
See Chapter 3 of the OpenWindows Installation and Start-Up Guide for the settings for international keyboards. 


app-def aults Directory in /usr/openwin/lib/app-def aults Must Be Moved 

The app-def aults directory in /usr/openwin/lib/app-def aults should be moved to 
/usr/openwin/lib/Xll/app-def aults before installing OpenWindows on your system. To make the 
change, become superuser and enter the following commands: 


wsun 

mlCTosystems 
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r . 

%su 

■ ' 1 

Password.: lenttr root password} 


#cd /usr/openwin/lib 


#inkdLir XI1 


#inv app-defaults Xll 


_ 



Ronning NeWS Applications on a Non-Networked Standalone System 

In order to nm NeWS applications on a standalone workstation that is not connected to a network, you must start 
OpenWindows with the -noauth option so that security is not enabled. 


LED’s on Type-4 Keyboards Flash When Cursor Moves Across SunVIew Programs Running under 
OpenWindovrs 

On Type-4 keyboards, all four keyboard LEDs (the green lights on the upper-right part of the keyboard) flash briefly 
whenever the cursor moves into or out of a SunView program that is running in an OpenWindows window. 


Problem with FI (Help) Key on Type-4 Keyboards 

On Type-4 keyboards, the FI (Help) key does not work properly if either Caps Lock or Num Lock is on. 


Error Message for Incorrect Permissions on /tmp Directory 

If OpenWindows displays the error message: 


- 

XNeWS: there is already a NeWS server running on :0 
giving up. 

/usr/openwin/bin/xinit: Permission denied (errno 13): unable to 

connect to X server 

^ ______) 


check the permissions on the /tmp directory. They should be: drwxrwsrwt. 


Do Not Resize Text Sub-Window Smaller Than the Top of the Bottommost Split 

Resizing split text sub-windows smaller than the top of the bottommost split causes the program that owns the text 
sub- window to crash. Any changes in any of the program’s windows that have not been saved previously are lost. 

This bug affects File Manager, Mail Tool, and Textedit, as well as all other application programs that use text 
sub-windows. If you are using the split feature of text sub-windows, you should not resize the text sub-window 
smaller than the top of the bottommost split. 


Asun 
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Information on Keyboard Map File for Japanese International Keyboard 

The keyboard map file for the Japanese international keyboard is Japan4 . ps. See Chapter 3 of the OpenWindows 
Installation and Start-Up Guide for more information. 


Mail Tool; Running out of Disk Space in / tmp 

Mail Tool does not handle running out of disk space in /tmp gracefully. If you have too large a mail spool file, or 
too little space in /tmp, Mail Tool may give an error message, terminate, and possibly leave a lock file, which you 
wiU need to remove, in /usr/spool/mail. The name of the file is username.lock. To remove the lock file, 
enter: 


r 

xm /MBr/Bpool/maiLl/username.lock 

A 

k . :,::x ^ 

.. . . . , J 


If Mail Tool runs out of space in /tmp while running, it is possible that deleting messages from the In Tray may 
result in the deleted messages being duplicated and sequenced out of order. 

It is recommended that you hold down the size of your spool file by limiting the number of messages in your In Tray. 
In addition, you can conserve disk space by removing unnecessary files from the filesystem containing /tmp. 


Do Not Disable Scrolling in One of the Windows of a Split-Screen Command Tool 

Disabling scrolling in one of the windows of a split-screen Command Tool may cause it to crash. 


File Manager Can Crash If Too Many Editing Sessions Are Started 

The File Manager can crash if too many editing sessions are started in a short period of time. When this happens, aU 
unsaved changes are lost. To prevent such crashes, Sun strongly recommends that you do the following: 

1. Select Tool Properties from the Properties menu button on the File Manager control panel. 

2. Click on the Other option next to Default Document Editor. 

3. Fill in tte blank with: 

textedit "$FILE" 

4. Press the Apply button at the bottom of the window. 


File Manager’s Wastebasket Icon May Be Invisible Or Appears As a Short Text String with No Picture 

If the File Manager’s Wastebasket icon appears as a short text string with no picture, double-click on the string. This 
will open up the Wastebasket window. When you close the Wastebasket window, the icon will assume its normal 
appearance. 

If the Wastebasket icon is initially invisible, exit and restart the File Manager. In most cases, this wiU solve the prob¬ 
lem. If the icon is still not visible, either clicking around the edge of the screen where your other icons are located or 
select Screen Refresh from the Utilities menu. Screen Refresh produces a short text string, as described 
above. Follow the previous instructions to get the normal Wastebasket icon. 
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Use SueView for Maxiinum Security Levels 

If you require maximum levels of security, use the SunView window system. Sun View, which is a kernel-based win¬ 
dow system, presents a more secure environment than a netwoiked window system such as Open Windows. (Refer to 
the OpenWindows Release Notes, page 13, for a detailed description of OpenWindows security.) 


Application Programs Can Move Windows in Front of the Screen Lock on Monochrome Monitors 

On monochrome monitors, application programs can move new or updated windows in front of the Screen Lock. As 
a result, the contents of a window may be displayed even when the screen is locked. This can happen, for example, if 
you lock the screen as soon as you start saving a large Mail Tool infile. When the Mail Tool save is completed, the 
message view window will still be displayed, in spite of the screen lock. Color monitors do not exhibit this problem. 


OpenWindows Supports Monitors with Overscan Capabilities 

OpenWindows Version 2 supports monitors with overscan capabilities. For monitors running in overscan mode, the 
server can be started up with an adjusted viewing size in order to compensate. 

In future systems, the need to run in overscan mode may automatically be determined at startup time. However, there 
will be occasions when XI 1/NeWS is run on a second non-overscan monitor on monitors that are not properly 
aligned, or are of an unusual size. In these cases, overscan mode may have to be shut off or the dimensions of the visi¬ 
ble area changed. To allow for the eventualities, the following command-line arguments will be supported by 
Xll/NeWS once the overscan code is installed. 

o -dev [fbname] 

This option will teU the server what device to display on. This replaces the usage of the FRAMEBUFFER 
environment variable in OpenWindows 1.0. 

□ -overscan [percent] 

This option instructs the server to shrink the visible area by the indicated percentage and perform the necessary 
offsetting. If a percentage of -1 is given, the shrinkage will be set to the default. If a percentage of 0 is given, 
overscan mode will be disabled and the server will use the full size of the screen. This will allow users to over¬ 
ride any defaults if a particular monitor doesn’t behave to their liking. 

In addition, if the -overscan option passes a non-zero value, it will enable the special overscan functionality (the 
flooding of the unused border regions with the root X color/pattem and the constraining of the cursor to the root 
canvas). 

□ -rect [LTWH] 

This option instructs the server to use a viewing area described by the rectangle passed in. Note that this mode 
will not perform the special cursor/border functions which are part of overscan mode unless overscan mode is 
also enabled. This option simply sets an explicit viewing area. 

Examples: 


^sun 

microsysterre 


Revision A of 30 October 1990, Part Number 800-5566-10 



READ THIS FIRST SunOS Release 4.1.1 15 


#'Ruri" xnews in default overscan mode,, overriding any defaults, 
xnews -overscan -1 

# Run xnews in Overscan mode but with a set shrinkage Of 10%, 

# overriding any defaults, 
xnews -overscan 10 

# Run xnews with overscan mode off, overriding any defaults, 
xnews -overscan 0 

# Run xnews with an explicit view area and overscan mode shut off, 

# overriding any defaults. 

xnews -overscan 0 -rect 200 200 600 600 

V_ 


GX Hardware Cursor May Be Left on Screen after Exiting OpenWindows 

There are some cases in which the GX hardware cursor is left on the screen after exiting OpenWindows. The wor¬ 
karound is to run the following program: 
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/* 

* gxcursor -- disable GX cursor 

* to compile: cc -0 -o gxcursor gxcursor.c -Ipixrect 

*/ 

#include <stdio.h> 

#include <sys/types.h> 
finclude <sys/ioctl.h> 

#include <sun/fbio.h> 

#include <pixrect/pixrect.h> 

#include <pixrect/memvar.h> 


struct cg6pr { 

struct mprp_data mprp; 

int fd; 

struct pr_size cg6_size; 
caddr_t cg6_fbc; 
caddr t cg6 tec; 


/* memory pixrect simulator */ 
/* device file descriptor */ 

/* screen size */ 

/* FBC base */ 

/* TEC base */ 


#define THCOFFSET 
#define THC CURSOR 


(5 * 4096) 
OxSFC 


main(argc, argv) 
int argc; 
char *argv[]; 


char *dev = argc > 1 ? argv[l] : "/dev/fb"; 

int fd; 

struct fbgattr fbattr; 

Pixrect *pr; 

if ((fd = open(dev, 2, 0)) < 0) 
perror(dev); 

if (ioctKfd, FBIOGATTR, Sfbattr) <0 11 

fbattr.fbtype.fb_type != FBTYPE_SUNFAST_COLOR) 

fprintf(stderr, "device %s is not a GX frame bufferO, dev); 

(void) close(fd); 

if ((pr = pr_open(dev)) == 0) 

fprintf(stderr, "pixrect open failed for %s0, dev); 

* (int *) (((struct cg6pr *) pr->pr_data)->cg6_fbc + 

THCOFFSET + THC_CURSOR) = OxffeOffeO; 

exit (0); 
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GX with OpenWindows on Multiple Screens: Some Operations May Leave Cursor Invisible 

When you run on a GX and have OpenWindows displayed on multiple screens, operations that warp the cursor to a 
new position (such as scrollbars and pop-ups) may leave the cursor invisible imtil you move the mouse. This 
behavior does not start until after the mouse cursor visits the non-GX screen. Once the disappearing cursor starts, it 
is non-deterministic (due to a race condition), so it shows up about 50% of the time. Three workarounds follow: 

□ Set the Scrollbar Pointer Jumping and Pop-up Pointer Jumping properties in the “Mouse 
Settings” Workspace property sheet to off, then restart OpenWindows. This fixes the most common XView 
symptoms. 

□ Adjust the OpenWindows . Popup JumpCursor and Scrollbar . JumpCur sor properties in the 
~ / . Xdef aults file to be False, Forexample: 

OpenWindows.PopupJumpCursor: False 

Scrollbar.JumpCursor: False 

This fixes the most common XView symptoms. 

□ Permanently disable the new hardware cursor tracking feature in the kernel by adjusting a kernel variable and 
rebooting: 


f - 


%3U 


Password: [ enter root password] 


#adb -w /vinunix /dev/kmem 


not cote file = /dev/kmem 


win do hw cursor?W 0 


$quit 


#/etc/fastboot 



J 


Under this workaround, cursor tracking may lag behind mouse motion in some circumstances. 


BadAlloc Xerror Results from Large Number of Panel Items 

In XView, the number of panel items is unlimited. However, after a certain point, the server will run out of virtual 
memory with the message: 

BadAlloc Xerror 


Using CANVAS__PAINTWIND0W_ATTRS in the Create Call of a Canvas May Not Work Correctly 

Due to a bug in the XView canvas package, trying to set some canvas paint window attributes using 
CANVAS__PAINTWIND0W__ATTRS in the create call of a canvas will not work correctly. The attributes that fail are 
WIN_BIT_GRAVITY and anything that adjusts the window’s event mask (e.g., WlN_CONSUME__EVENT ( S ) and 
WIN__IGNORE_EVENT (S )). The work around is to set the CANVAS_PAINTWINDOW_ATTRS after the canvas has 
been created. 

For example, given: 
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' ^ — — s 

canvas = (Canvas)xv__create(frame, CANVAS^ 

• . . f 

CANVAS___PAINTWINDOW_ATTRS, 

WIN_BIT_GRAVITY, SouthWestGravity, 

WIN_CONSUME_EVENT, LOC_DRAG, 

0 , 

• • • f 

0 ) ; 

V... .. ... 


you would produce the following: 

^ 

canvas = (Canvas)xv_create(frame^ CANVAS, 

• • • f 

• • • f 
0 ) ; 

xv_set(canvas, 

CANVAS_PAINTWINDOW_ATTRS, 

WIN_BIT_GRAVITY, SouthWestGravity, 

WIN_CONSUME_EVENT, LOC_DRAG, 

0 , 

0 ) ; 

V_____/ 


Three Methods for Creating XVIew Fonts 
XView fonts can be created by the following methods: 
□ Creation by specifying the font name: 


-----^ 

font = xv_create (frame, FONT, 

FONT_NAME, ”lucidatypewriter-bold~14”, 

NULL); 

<_^ 


□ Creation by resizing a previously created font: 


r 

A 

font = XV create(frame, FONT, 


FONT RESCALE_OF, Other font, WIN SCALE__LARGE, 


NULL); 



J 


□ Creation by specifying family, style, and scale: 
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f 



font = 

= XV create(frame, FONT, 

FONT_FAMILY, FONT_FAMILY_LUCIDA, 

FONT__STYLE, FONT_STYLE_BOLD, 

FONT_SIZE, 10, 

NULL); 


V 


J 


The third method, font creation by specify family, style, and scale, is the only method that always guarantees correct 
information about F0NT_SIZE, FONT_STYLE, and F0NT_FAMILY. However, there are circumstances in which 
the other two methods will reliably return correct values: 

□ Creating by resizing will return correct values if the original font was created by specifying family/style/scale. 

□ If the font name is specified in the X Logical Font Description (XLFD) format, XView will decrypt the font name 
to extract the correct FONT_SIZE, FONT_STYLE, and FONT_VALUE values. 

□ Some other weU known names, such as lucida-12, lucidatypewriter-bold-12, and cour.r.18, are also decrypted 
correctly, but is only for compatibility purposes. 

In any event, one should always check the values returned by xv_get before using them. 


Using DM 

□ If you run the XI 1/NeWS server over DNI, you wiU crash the server if you view an access list using xho st 
after adding a host to the list with newshost. 

□ You must unset the environment variable DNI_X_ENABLE before starting the server if DNI is not in a mode 
that accepts connections. 

□ If you turn off the network node state while the server is running, you wiU crash the server. 

□ You can cut text from an OpenWindows application into a DEC application, but not from a DEC application to 
OpenWindows. 
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OPENWINDOWS V2 ON~^LINE TUTORIAL 

This on-line tutorial provides instruction on aU the basic skills necessary for becoming a capable end-user of Sun 
Microsystems’ OpenWindows software. In addition to the easy-to-follow explanations, the tutorial offers demonstra¬ 
tions or simple animated examples of how the software works. 

The demonstrations are designed to display the software in detail and first-time users may find them especially help¬ 
ful. Because the demonstrations’ animated scripts create a separate environment, you have to turn off system security 
in order to run them. 

You can, however, run the tutorial without accessing the demonstrations. This allows you to call up the tutorial for 
reference at anytime you are running OpenWindows and need a quick reminder. 

There are two ways to view the on-line tutorial: 

□ With animated demonstrations 
and 

o Without the animated demonstrations 



The animated demonstrations run on Sun’s standard monochrome and color 
monitors (1152 X 900 pixels). They do not run correctly on the high resolution 

monitor (1600 X 1280 pixels). If you attempt to view an animated demonstration 
while running OpenWindows on a high-resolution monochrome monitor, an 
alert to this effect appears onscreen. 

You should also be aware that the demonstrations included with your on-line 
tutorial were designed to work using OpenWindows’ default settings. It is possi¬ 
ble to change these settings (as the on-line tutorial itself explains), but if you do, 
the animated demonstrations may not perform correctly. 



Do not move the moose or press any mouse buttons or keyboard keys while 

a demonstration plays. This will Interrupt the demonstration and can cause 
your system to crash. 


Accessing the On-Line Tutorial with Animated Demonstrations 
To access the on-line tutorial with animated demonstrations: 


1. Exit OpenWindows. 

To exit OpenWindows, press and hold the right mouse button anywhere in the background of your screen (wher¬ 
ever there is no window or icon). A Workspace menu appeare. Still holding the right mouse button down, drag 
down, highlight Exit, and release the mouse button. 

If you are using the SunOS 4.1.1 default . login file, exiting OpenWindows wiU log you off the system. In 
this case, you need to log back in and press I Control-C I when you see the prompt: 


starting OpenWindows (Control-C to interrupt) 
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2. At the % prompt on a full screen without windows, enter: 


- -- ^^ 

%/usr/openwin/cleino/tutorial/start__tutorial 

\^ 


The on-line tutorial appears on your screen with a Console window displayed nearby. Do not quit the Console win¬ 
dow; it is there to accept system messages for you. 

Proceed to the tutorial section titled “Introduction-Read This First” for instructions on using the on-line tutorial. To 
do this, click the left mouse button twice in rapid succession on the screen button marked “GoTo” beside the words 
“Introduction-Read This First.” 


Returning to OpenWindows 

To return to OpenWindows when you finish the on-line tutorial: 

1. Exit OpenWindows (as described in the previous section). 

2. At the prompt enter: 

_ ^ __— 

%/usr/openwin/bin/openwin 

V _. .■:. ^i_ J 


Accessing the On-Line Tutorial without Animated Demonstrations 

To access the on-line tutorial without animated demonstrations, from within OpenWindows enter: 


%/usr/openwin/denJo/tutorial/tutorial. sh 

... '■ 'N 

J 

An alert appears on screen: 


Security is on. 

You must start server with either: 

openwin/demo/tutorial/start_tutorial 
openwin/bin/openwin -defeateventsecurity 

> 

L . . 

J 


This is to remind you that security is on and animated demonstrations are not available. As long as you continue in 
the current mode (without demonstrations), a similar alert appears whenever you attempt to call up an animated 
demonstration. 

We recommend that you operate the on-line tutorial without animated demonstrations whenever you want a quick 
refresher on OpenWindows features, tools, utilities, or functions. 


Moving Around in the Tutorial 

When the tutorial comes up on your screen, the first thing you see is the Table of Contents. Next to each topic is a 
“GoTo” button. To learn about any topic or feature listed in the Table of Contents, position your mouse cursor over 
the GoTo button next to the topic you want and double-click using SELECT (the left mouse button). This takes you 
to the first page of the selected section of the tutorial. 
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Closing the Tutorial 

When you are done with the tutorial, or if you want to take a break, you can close the on-line tutorial window to an 
icon on your screen. 

To close the on-line tutorial window, put your cursor in the lx)rder of the window. Press and hold MENU (right 
mouse button) and a pop-up window appears. Pull your cursor down to highlight the Close option and release the 

mouse button. The on-line tutorial is then suspended and a small icon appears on your monitor screen. 

There are two ways to reopen the on-line tutorial from its icon. You can double-click SELECT (left mouse button) 
on the icon and the on-line tutorial re-opens for use. You can also press and hold the right mouse button (MENU) 
over the icon; when the menu appears, highlight the Open option and release the mouse button. 


Quitting the On-Line Tutorial 

Instead of closing the on-line tutorial, you can quit and exit the application entirely. To quit the on-line tutorial, posi¬ 
tion your cursor either in the tutorial window border or over the tutorial icon. Call up the window menu by pressing 
and holding MENU (right mouse button) and then highlight the Quit option. The tutorial window (or the icon) then 
disappears from the screen. 


Training Courses 

Sun Educational Services offers advanced training on OpenWindows as weU as other Sun hardware and software, sys¬ 
tem administration, and end-user training. You can call us or send electronic mail to request information or a catalog 
of our courses and class schedules. 

Customers who have a large number of employees to train may wish to arrange for a course to be taught on-site. 
Courses are offered in all parts of the world—check with your local Sun sales office for more information and com¬ 
plete details. We respond by phone, electronic mail, or fax machine. 

□ For more information on Sun training courses at a training center in the United States: 

Sun U.S. Training Courses 
1-800-422-8020 

o If you are calling from outside the United States: 

Call 1-408-276-3630 

□ For more information on Sun training courses at a training center in Canada: 

Sun Canadian Training Courses 

1_416-477-6745, Extension 2723 
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